<?xml version="1.0" encoding="ascii"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
          "DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
  <title>simvoc.core.units</title>
  <link rel="stylesheet" href="epydoc.css" type="text/css" />
  <script type="text/javascript" src="epydoc.js"></script>
</head>

<body bgcolor="white" text="black" link="blue" vlink="#204080"
      alink="#204080">
<!-- ==================== NAVIGATION BAR ==================== -->
<table class="navbar" border="0" width="100%" cellpadding="0"
       bgcolor="#a0c0ff" cellspacing="0">
  <tr valign="middle">
  <!-- Home link -->
      <th>&nbsp;&nbsp;&nbsp;<a
        href="simvoc-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>

  <!-- Tree link -->
      <th>&nbsp;&nbsp;&nbsp;<a
        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>

  <!-- Index link -->
      <th>&nbsp;&nbsp;&nbsp;<a
        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>

  <!-- Help link -->
      <th>&nbsp;&nbsp;&nbsp;<a
        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>

  <!-- Project homepage -->
      <th class="navbar" align="right" width="100%">
        <table border="0" cellpadding="0" cellspacing="0">
          <tr><th class="navbar" align="center"
            >SimVOC</th>
          </tr></table></th>
  </tr>
</table>
<table width="100%" cellpadding="0" cellspacing="0">
  <tr valign="top">
    <td width="100%">
      <span class="breadcrumbs">
        <a href="simvoc-module.html">Package&nbsp;simvoc</a> ::
        <a href="simvoc.core-module.html">Package&nbsp;core</a> ::
        Module&nbsp;units
      </span>
    </td>
    <td>
      <table cellpadding="0" cellspacing="0">
        <!-- hide/show private -->
        <tr><td align="right"><span class="options">[<a href="javascript:void(0);" class="privatelink"
    onclick="toggle_private();">hide&nbsp;private</a>]</span></td></tr>
      </table>
    </td>
  </tr>
</table>
<h1 class="epydoc">Source Code for <a href="simvoc.core.units-module.html">Module simvoc.core.units</a></h1>
<pre class="py-src">
<a name="L1"></a><tt class="py-lineno">  1</tt>  <tt class="py-line"><tt class="py-comment">#!/usr/bin/env python</tt> </tt>
<a name="L2"></a><tt class="py-lineno">  2</tt>  <tt class="py-line"><tt class="py-comment">#</tt> </tt>
<a name="L3"></a><tt class="py-lineno">  3</tt>  <tt class="py-line"><tt class="py-comment"># Various units for simulation convenience</tt> </tt>
<a name="L4"></a><tt class="py-lineno">  4</tt>  <tt class="py-line"><tt class="py-comment">#</tt> </tt>
<a name="L5"></a><tt class="py-lineno">  5</tt>  <tt class="py-line"><tt class="py-comment"># Author:   Mike Murphy &lt;mamurph@cs.clemson.edu&gt;</tt> </tt>
<a name="L6"></a><tt class="py-lineno">  6</tt>  <tt class="py-line"><tt class="py-comment"># Revision: 23 September 2009</tt> </tt>
<a name="L7"></a><tt class="py-lineno">  7</tt>  <tt class="py-line"><tt class="py-comment">#</tt> </tt>
<a name="L8"></a><tt class="py-lineno">  8</tt>  <tt class="py-line"><tt class="py-comment">#   Copyright 2009 Clemson University</tt> </tt>
<a name="L9"></a><tt class="py-lineno">  9</tt>  <tt class="py-line"><tt class="py-comment">#</tt> </tt>
<a name="L10"></a><tt class="py-lineno"> 10</tt>  <tt class="py-line"><tt class="py-comment">#   Licensed under the Apache License, Version 2.0 (the "License");</tt> </tt>
<a name="L11"></a><tt class="py-lineno"> 11</tt>  <tt class="py-line"><tt class="py-comment">#   you may not use this file except in compliance with the License.</tt> </tt>
<a name="L12"></a><tt class="py-lineno"> 12</tt>  <tt class="py-line"><tt class="py-comment">#   You may obtain a copy of the License at</tt> </tt>
<a name="L13"></a><tt class="py-lineno"> 13</tt>  <tt class="py-line"><tt class="py-comment">#</tt> </tt>
<a name="L14"></a><tt class="py-lineno"> 14</tt>  <tt class="py-line"><tt class="py-comment">#       http://www.apache.org/licenses/LICENSE-2.0</tt> </tt>
<a name="L15"></a><tt class="py-lineno"> 15</tt>  <tt class="py-line"><tt class="py-comment">#</tt> </tt>
<a name="L16"></a><tt class="py-lineno"> 16</tt>  <tt class="py-line"><tt class="py-comment">#   Unless required by applicable law or agreed to in writing, software</tt> </tt>
<a name="L17"></a><tt class="py-lineno"> 17</tt>  <tt class="py-line"><tt class="py-comment">#   distributed under the License is distributed on an "AS IS" BASIS,</tt> </tt>
<a name="L18"></a><tt class="py-lineno"> 18</tt>  <tt class="py-line"><tt class="py-comment">#   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</tt> </tt>
<a name="L19"></a><tt class="py-lineno"> 19</tt>  <tt class="py-line"><tt class="py-comment">#   See the License for the specific language governing permissions and</tt> </tt>
<a name="L20"></a><tt class="py-lineno"> 20</tt>  <tt class="py-line"><tt class="py-comment">#   limitations under the License.</tt> </tt>
<a name="L21"></a><tt class="py-lineno"> 21</tt>  <tt class="py-line"><tt class="py-comment">#</tt> </tt>
<a name="L22"></a><tt class="py-lineno"> 22</tt>  <tt class="py-line"><tt class="py-comment"># This material is based upon work supported under a National Science</tt> </tt>
<a name="L23"></a><tt class="py-lineno"> 23</tt>  <tt class="py-line"><tt class="py-comment"># Foundation Graduate Research Fellowship. Any opinions, findings,</tt> </tt>
<a name="L24"></a><tt class="py-lineno"> 24</tt>  <tt class="py-line"><tt class="py-comment"># conclusions or recommendations expressed in this publication are those of</tt> </tt>
<a name="L25"></a><tt class="py-lineno"> 25</tt>  <tt class="py-line"><tt class="py-comment"># the author(s) and do not necessarily reflect the views of the National</tt> </tt>
<a name="L26"></a><tt class="py-lineno"> 26</tt>  <tt class="py-line"><tt class="py-comment"># Science Foundation.</tt> </tt>
<a name="L27"></a><tt class="py-lineno"> 27</tt>  <tt class="py-line"> </tt>
<a name="L28"></a><tt class="py-lineno"> 28</tt>  <tt class="py-line"><tt class="py-docstring">'''</tt> </tt>
<a name="L29"></a><tt class="py-lineno"> 29</tt>  <tt class="py-line"><tt class="py-docstring">Various units of time, size, etc. for simulation convenience. All unit names</tt> </tt>
<a name="L30"></a><tt class="py-lineno"> 30</tt>  <tt class="py-line"><tt class="py-docstring">begin with the prefix u_, to avoid namespace collisions if all units are</tt> </tt>
<a name="L31"></a><tt class="py-lineno"> 31</tt>  <tt class="py-line"><tt class="py-docstring">imported into the working namespace.</tt> </tt>
<a name="L32"></a><tt class="py-lineno"> 32</tt>  <tt class="py-line"><tt class="py-docstring">'''</tt> </tt>
<a name="L33"></a><tt class="py-lineno"> 33</tt>  <tt class="py-line"> </tt>
<a name="L34"></a><tt class="py-lineno"> 34</tt>  <tt class="py-line"> </tt>
<a name="L35"></a><tt class="py-lineno"> 35</tt>  <tt class="py-line"><tt class="py-comment">############################# Size Constants (in bytes) #####################</tt> </tt>
<a name="L36"></a><tt class="py-lineno"> 36</tt>  <tt class="py-line"> </tt>
<a name="L37"></a><tt class="py-lineno"> 37</tt>  <tt class="py-line"><tt id="link-0" class="py-name" targets="Variable simvoc.core.units.u_KB=simvoc.core.units-module.html#u_KB"><a title="simvoc.core.units.u_KB" class="py-name" href="#" onclick="return doclink('link-0', 'u_KB', 'link-0');">u_KB</a></tt> <tt class="py-op">=</tt> <tt class="py-number">10</tt><tt class="py-op">**</tt><tt class="py-number">3</tt> </tt>
<a name="L38"></a><tt class="py-lineno"> 38</tt>  <tt class="py-line"><tt id="link-1" class="py-name" targets="Variable simvoc.core.units.u_KiB=simvoc.core.units-module.html#u_KiB"><a title="simvoc.core.units.u_KiB" class="py-name" href="#" onclick="return doclink('link-1', 'u_KiB', 'link-1');">u_KiB</a></tt> <tt class="py-op">=</tt> <tt class="py-number">2</tt><tt class="py-op">**</tt><tt class="py-number">10</tt> </tt>
<a name="L39"></a><tt class="py-lineno"> 39</tt>  <tt class="py-line"><tt id="link-2" class="py-name" targets="Variable simvoc.core.units.u_MB=simvoc.core.units-module.html#u_MB"><a title="simvoc.core.units.u_MB" class="py-name" href="#" onclick="return doclink('link-2', 'u_MB', 'link-2');">u_MB</a></tt> <tt class="py-op">=</tt> <tt class="py-number">10</tt><tt class="py-op">**</tt><tt class="py-number">6</tt> </tt>
<a name="L40"></a><tt class="py-lineno"> 40</tt>  <tt class="py-line"><tt id="link-3" class="py-name" targets="Variable simvoc.core.units.u_MiB=simvoc.core.units-module.html#u_MiB"><a title="simvoc.core.units.u_MiB" class="py-name" href="#" onclick="return doclink('link-3', 'u_MiB', 'link-3');">u_MiB</a></tt> <tt class="py-op">=</tt> <tt class="py-number">2</tt><tt class="py-op">**</tt><tt class="py-number">20</tt> </tt>
<a name="L41"></a><tt class="py-lineno"> 41</tt>  <tt class="py-line"><tt id="link-4" class="py-name" targets="Variable simvoc.core.units.u_GB=simvoc.core.units-module.html#u_GB"><a title="simvoc.core.units.u_GB" class="py-name" href="#" onclick="return doclink('link-4', 'u_GB', 'link-4');">u_GB</a></tt> <tt class="py-op">=</tt> <tt class="py-number">10</tt><tt class="py-op">**</tt><tt class="py-number">9</tt> </tt>
<a name="L42"></a><tt class="py-lineno"> 42</tt>  <tt class="py-line"><tt id="link-5" class="py-name" targets="Variable simvoc.core.units.u_GiB=simvoc.core.units-module.html#u_GiB"><a title="simvoc.core.units.u_GiB" class="py-name" href="#" onclick="return doclink('link-5', 'u_GiB', 'link-5');">u_GiB</a></tt> <tt class="py-op">=</tt> <tt class="py-number">2</tt><tt class="py-op">**</tt><tt class="py-number">30</tt> </tt>
<a name="L43"></a><tt class="py-lineno"> 43</tt>  <tt class="py-line"><tt id="link-6" class="py-name" targets="Variable simvoc.core.units.u_TB=simvoc.core.units-module.html#u_TB"><a title="simvoc.core.units.u_TB" class="py-name" href="#" onclick="return doclink('link-6', 'u_TB', 'link-6');">u_TB</a></tt> <tt class="py-op">=</tt> <tt class="py-number">10</tt><tt class="py-op">**</tt><tt class="py-number">12</tt> </tt>
<a name="L44"></a><tt class="py-lineno"> 44</tt>  <tt class="py-line"><tt id="link-7" class="py-name" targets="Variable simvoc.core.units.u_TiB=simvoc.core.units-module.html#u_TiB"><a title="simvoc.core.units.u_TiB" class="py-name" href="#" onclick="return doclink('link-7', 'u_TiB', 'link-7');">u_TiB</a></tt> <tt class="py-op">=</tt> <tt class="py-number">2</tt><tt class="py-op">**</tt><tt class="py-number">40</tt> </tt>
<a name="L45"></a><tt class="py-lineno"> 45</tt>  <tt class="py-line"><tt id="link-8" class="py-name" targets="Variable simvoc.core.units.u_PB=simvoc.core.units-module.html#u_PB"><a title="simvoc.core.units.u_PB" class="py-name" href="#" onclick="return doclink('link-8', 'u_PB', 'link-8');">u_PB</a></tt> <tt class="py-op">=</tt> <tt class="py-number">10</tt><tt class="py-op">**</tt><tt class="py-number">15</tt> </tt>
<a name="L46"></a><tt class="py-lineno"> 46</tt>  <tt class="py-line"><tt id="link-9" class="py-name" targets="Variable simvoc.core.units.u_PiB=simvoc.core.units-module.html#u_PiB"><a title="simvoc.core.units.u_PiB" class="py-name" href="#" onclick="return doclink('link-9', 'u_PiB', 'link-9');">u_PiB</a></tt> <tt class="py-op">=</tt> <tt class="py-number">2</tt><tt class="py-op">**</tt><tt class="py-number">50</tt> </tt>
<a name="L47"></a><tt class="py-lineno"> 47</tt>  <tt class="py-line"> </tt>
<a name="L48"></a><tt class="py-lineno"> 48</tt>  <tt class="py-line"> </tt>
<a name="L49"></a><tt class="py-lineno"> 49</tt>  <tt class="py-line"><tt class="py-comment">############################# Speed Constants ###############################</tt> </tt>
<a name="L50"></a><tt class="py-lineno"> 50</tt>  <tt class="py-line"> </tt>
<a name="L51"></a><tt class="py-lineno"> 51</tt>  <tt class="py-line"><tt class="py-comment"># Network speeds are ALWAYS specified in decimal bits/bytes per sec. These</tt> </tt>
<a name="L52"></a><tt class="py-lineno"> 52</tt>  <tt class="py-line"><tt class="py-comment"># constants are in terms of BYTES.</tt> </tt>
<a name="L53"></a><tt class="py-lineno"> 53</tt>  <tt class="py-line"> </tt>
<a name="L54"></a><tt class="py-lineno"> 54</tt>  <tt class="py-line"><tt id="link-10" class="py-name" targets="Variable simvoc.core.units.u_Kbps=simvoc.core.units-module.html#u_Kbps"><a title="simvoc.core.units.u_Kbps" class="py-name" href="#" onclick="return doclink('link-10', 'u_Kbps', 'link-10');">u_Kbps</a></tt> <tt class="py-op">=</tt> <tt class="py-number">125</tt> </tt>
<a name="L55"></a><tt class="py-lineno"> 55</tt>  <tt class="py-line"><tt id="link-11" class="py-name" targets="Variable simvoc.core.units.u_KBps=simvoc.core.units-module.html#u_KBps"><a title="simvoc.core.units.u_KBps" class="py-name" href="#" onclick="return doclink('link-11', 'u_KBps', 'link-11');">u_KBps</a></tt> <tt class="py-op">=</tt> <tt class="py-number">1000</tt> </tt>
<a name="L56"></a><tt class="py-lineno"> 56</tt>  <tt class="py-line"><tt id="link-12" class="py-name" targets="Variable simvoc.core.units.u_Mbps=simvoc.core.units-module.html#u_Mbps"><a title="simvoc.core.units.u_Mbps" class="py-name" href="#" onclick="return doclink('link-12', 'u_Mbps', 'link-12');">u_Mbps</a></tt> <tt class="py-op">=</tt> <tt class="py-number">125000</tt> </tt>
<a name="L57"></a><tt class="py-lineno"> 57</tt>  <tt class="py-line"><tt id="link-13" class="py-name" targets="Variable simvoc.core.units.u_MBps=simvoc.core.units-module.html#u_MBps"><a title="simvoc.core.units.u_MBps" class="py-name" href="#" onclick="return doclink('link-13', 'u_MBps', 'link-13');">u_MBps</a></tt> <tt class="py-op">=</tt> <tt class="py-number">10</tt><tt class="py-op">**</tt><tt class="py-number">6</tt> </tt>
<a name="L58"></a><tt class="py-lineno"> 58</tt>  <tt class="py-line"><tt id="link-14" class="py-name" targets="Variable simvoc.core.units.u_Gbps=simvoc.core.units-module.html#u_Gbps"><a title="simvoc.core.units.u_Gbps" class="py-name" href="#" onclick="return doclink('link-14', 'u_Gbps', 'link-14');">u_Gbps</a></tt> <tt class="py-op">=</tt> <tt class="py-number">125000000</tt> </tt>
<a name="L59"></a><tt class="py-lineno"> 59</tt>  <tt class="py-line"><tt id="link-15" class="py-name" targets="Variable simvoc.core.units.u_GBps=simvoc.core.units-module.html#u_GBps"><a title="simvoc.core.units.u_GBps" class="py-name" href="#" onclick="return doclink('link-15', 'u_GBps', 'link-15');">u_GBps</a></tt> <tt class="py-op">=</tt> <tt class="py-number">10</tt><tt class="py-op">**</tt><tt class="py-number">9</tt> </tt>
<a name="L60"></a><tt class="py-lineno"> 60</tt>  <tt class="py-line"> </tt>
<a name="L61"></a><tt class="py-lineno"> 61</tt>  <tt class="py-line"> </tt>
<a name="L62"></a><tt class="py-lineno"> 62</tt>  <tt class="py-line"><tt class="py-comment">############################# Time Constants ################################</tt> </tt>
<a name="L63"></a><tt class="py-lineno"> 63</tt>  <tt class="py-line"> </tt>
<a name="L64"></a><tt class="py-lineno"> 64</tt>  <tt class="py-line"><tt class="py-comment"># Two granularity sets: SG (seconds) and MG (minutes). Pick one per experiment,</tt> </tt>
<a name="L65"></a><tt class="py-lineno"> 65</tt>  <tt class="py-line"><tt class="py-comment"># and BE CONSISTENT!</tt> </tt>
<a name="L66"></a><tt class="py-lineno"> 66</tt>  <tt class="py-line"> </tt>
<a name="L67"></a><tt class="py-lineno"> 67</tt>  <tt class="py-line"><tt id="link-16" class="py-name" targets="Variable simvoc.core.units.u_SG_SECOND=simvoc.core.units-module.html#u_SG_SECOND"><a title="simvoc.core.units.u_SG_SECOND" class="py-name" href="#" onclick="return doclink('link-16', 'u_SG_SECOND', 'link-16');">u_SG_SECOND</a></tt> <tt class="py-op">=</tt> <tt class="py-number">1</tt> </tt>
<a name="L68"></a><tt class="py-lineno"> 68</tt>  <tt class="py-line"><tt id="link-17" class="py-name" targets="Variable simvoc.core.units.u_SG_MINUTE=simvoc.core.units-module.html#u_SG_MINUTE"><a title="simvoc.core.units.u_SG_MINUTE" class="py-name" href="#" onclick="return doclink('link-17', 'u_SG_MINUTE', 'link-17');">u_SG_MINUTE</a></tt> <tt class="py-op">=</tt> <tt class="py-number">60</tt> </tt>
<a name="L69"></a><tt class="py-lineno"> 69</tt>  <tt class="py-line"><tt id="link-18" class="py-name" targets="Variable simvoc.core.units.u_SG_HOUR=simvoc.core.units-module.html#u_SG_HOUR"><a title="simvoc.core.units.u_SG_HOUR" class="py-name" href="#" onclick="return doclink('link-18', 'u_SG_HOUR', 'link-18');">u_SG_HOUR</a></tt> <tt class="py-op">=</tt> <tt class="py-number">3600</tt> </tt>
<a name="L70"></a><tt class="py-lineno"> 70</tt>  <tt class="py-line"><tt id="link-19" class="py-name" targets="Variable simvoc.core.units.u_SG_DAY=simvoc.core.units-module.html#u_SG_DAY"><a title="simvoc.core.units.u_SG_DAY" class="py-name" href="#" onclick="return doclink('link-19', 'u_SG_DAY', 'link-19');">u_SG_DAY</a></tt> <tt class="py-op">=</tt> <tt class="py-number">86400</tt> </tt>
<a name="L71"></a><tt class="py-lineno"> 71</tt>  <tt class="py-line"><tt id="link-20" class="py-name" targets="Variable simvoc.core.units.u_SG_WEEK=simvoc.core.units-module.html#u_SG_WEEK"><a title="simvoc.core.units.u_SG_WEEK" class="py-name" href="#" onclick="return doclink('link-20', 'u_SG_WEEK', 'link-20');">u_SG_WEEK</a></tt> <tt class="py-op">=</tt> <tt class="py-number">604800</tt> </tt>
<a name="L72"></a><tt class="py-lineno"> 72</tt>  <tt class="py-line"><tt id="link-21" class="py-name" targets="Variable simvoc.core.units.u_SG_FORTNIGHT=simvoc.core.units-module.html#u_SG_FORTNIGHT"><a title="simvoc.core.units.u_SG_FORTNIGHT" class="py-name" href="#" onclick="return doclink('link-21', 'u_SG_FORTNIGHT', 'link-21');">u_SG_FORTNIGHT</a></tt> <tt class="py-op">=</tt> <tt class="py-number">1209600</tt> </tt>
<a name="L73"></a><tt class="py-lineno"> 73</tt>  <tt class="py-line"><tt id="link-22" class="py-name" targets="Variable simvoc.core.units.u_SG_MONTH=simvoc.core.units-module.html#u_SG_MONTH"><a title="simvoc.core.units.u_SG_MONTH" class="py-name" href="#" onclick="return doclink('link-22', 'u_SG_MONTH', 'link-22');">u_SG_MONTH</a></tt> <tt class="py-op">=</tt> <tt class="py-number">2592000</tt>           <tt class="py-comment"># 30 days</tt> </tt>
<a name="L74"></a><tt class="py-lineno"> 74</tt>  <tt class="py-line"><tt id="link-23" class="py-name" targets="Variable simvoc.core.units.u_SG_QUARTER=simvoc.core.units-module.html#u_SG_QUARTER"><a title="simvoc.core.units.u_SG_QUARTER" class="py-name" href="#" onclick="return doclink('link-23', 'u_SG_QUARTER', 'link-23');">u_SG_QUARTER</a></tt> <tt class="py-op">=</tt> <tt class="py-number">7862400</tt>         <tt class="py-comment"># 13 weeks</tt> </tt>
<a name="L75"></a><tt class="py-lineno"> 75</tt>  <tt class="py-line"><tt id="link-24" class="py-name" targets="Variable simvoc.core.units.u_SG_YEAR=simvoc.core.units-module.html#u_SG_YEAR"><a title="simvoc.core.units.u_SG_YEAR" class="py-name" href="#" onclick="return doclink('link-24', 'u_SG_YEAR', 'link-24');">u_SG_YEAR</a></tt> <tt class="py-op">=</tt> <tt class="py-number">31536000</tt>           <tt class="py-comment"># 365 days</tt> </tt>
<a name="L76"></a><tt class="py-lineno"> 76</tt>  <tt class="py-line"> </tt>
<a name="L77"></a><tt class="py-lineno"> 77</tt>  <tt class="py-line"> </tt>
<a name="L78"></a><tt class="py-lineno"> 78</tt>  <tt class="py-line"><tt class="py-comment"># No seconds at MG</tt> </tt>
<a name="L79"></a><tt class="py-lineno"> 79</tt>  <tt class="py-line"><tt id="link-25" class="py-name" targets="Variable simvoc.core.units.u_MG_MINUTE=simvoc.core.units-module.html#u_MG_MINUTE"><a title="simvoc.core.units.u_MG_MINUTE" class="py-name" href="#" onclick="return doclink('link-25', 'u_MG_MINUTE', 'link-25');">u_MG_MINUTE</a></tt> <tt class="py-op">=</tt> <tt class="py-number">1</tt> </tt>
<a name="L80"></a><tt class="py-lineno"> 80</tt>  <tt class="py-line"><tt id="link-26" class="py-name" targets="Variable simvoc.core.units.u_MG_HOUR=simvoc.core.units-module.html#u_MG_HOUR"><a title="simvoc.core.units.u_MG_HOUR" class="py-name" href="#" onclick="return doclink('link-26', 'u_MG_HOUR', 'link-26');">u_MG_HOUR</a></tt> <tt class="py-op">=</tt> <tt class="py-number">60</tt> </tt>
<a name="L81"></a><tt class="py-lineno"> 81</tt>  <tt class="py-line"><tt id="link-27" class="py-name" targets="Variable simvoc.core.units.u_MG_DAY=simvoc.core.units-module.html#u_MG_DAY"><a title="simvoc.core.units.u_MG_DAY" class="py-name" href="#" onclick="return doclink('link-27', 'u_MG_DAY', 'link-27');">u_MG_DAY</a></tt> <tt class="py-op">=</tt> <tt class="py-number">1440</tt> </tt>
<a name="L82"></a><tt class="py-lineno"> 82</tt>  <tt class="py-line"><tt id="link-28" class="py-name" targets="Variable simvoc.core.units.u_MG_WEEK=simvoc.core.units-module.html#u_MG_WEEK"><a title="simvoc.core.units.u_MG_WEEK" class="py-name" href="#" onclick="return doclink('link-28', 'u_MG_WEEK', 'link-28');">u_MG_WEEK</a></tt> <tt class="py-op">=</tt> <tt class="py-number">10080</tt> </tt>
<a name="L83"></a><tt class="py-lineno"> 83</tt>  <tt class="py-line"><tt id="link-29" class="py-name" targets="Variable simvoc.core.units.u_MG_FORTNIGHT=simvoc.core.units-module.html#u_MG_FORTNIGHT"><a title="simvoc.core.units.u_MG_FORTNIGHT" class="py-name" href="#" onclick="return doclink('link-29', 'u_MG_FORTNIGHT', 'link-29');">u_MG_FORTNIGHT</a></tt> <tt class="py-op">=</tt> <tt class="py-number">20160</tt> </tt>
<a name="L84"></a><tt class="py-lineno"> 84</tt>  <tt class="py-line"><tt id="link-30" class="py-name" targets="Variable simvoc.core.units.u_MG_MONTH=simvoc.core.units-module.html#u_MG_MONTH"><a title="simvoc.core.units.u_MG_MONTH" class="py-name" href="#" onclick="return doclink('link-30', 'u_MG_MONTH', 'link-30');">u_MG_MONTH</a></tt> <tt class="py-op">=</tt> <tt class="py-number">43200</tt>             <tt class="py-comment"># 30 days</tt> </tt>
<a name="L85"></a><tt class="py-lineno"> 85</tt>  <tt class="py-line"><tt id="link-31" class="py-name" targets="Variable simvoc.core.units.u_MG_QUARTER=simvoc.core.units-module.html#u_MG_QUARTER"><a title="simvoc.core.units.u_MG_QUARTER" class="py-name" href="#" onclick="return doclink('link-31', 'u_MG_QUARTER', 'link-31');">u_MG_QUARTER</a></tt> <tt class="py-op">=</tt> <tt class="py-number">131040</tt>          <tt class="py-comment"># 13 weeks</tt> </tt>
<a name="L86"></a><tt class="py-lineno"> 86</tt>  <tt class="py-line"><tt id="link-32" class="py-name" targets="Variable simvoc.core.units.u_MG_YEAR=simvoc.core.units-module.html#u_MG_YEAR"><a title="simvoc.core.units.u_MG_YEAR" class="py-name" href="#" onclick="return doclink('link-32', 'u_MG_YEAR', 'link-32');">u_MG_YEAR</a></tt> <tt class="py-op">=</tt> <tt class="py-number">525600</tt>             <tt class="py-comment"># 365 days</tt> </tt>
<a name="L87"></a><tt class="py-lineno"> 87</tt>  <tt class="py-line"> </tt>
<a name="L88"></a><tt class="py-lineno"> 88</tt>  <tt class="py-line"> </tt>
<a name="L89"></a><tt class="py-lineno"> 89</tt>  <tt class="py-line"><tt class="py-comment"># Some oddball stuff for annual environmental simulations</tt> </tt>
<a name="L90"></a><tt class="py-lineno"> 90</tt>  <tt class="py-line"> </tt>
<a name="L91"></a><tt class="py-lineno"> 91</tt>  <tt class="py-line"><tt class="py-comment"># Northern hemisphere</tt> </tt>
<a name="L92"></a><tt class="py-lineno"> 92</tt>  <tt class="py-line"><tt id="link-33" class="py-name" targets="Variable simvoc.core.units.u_SG_WINTER_NORTH=simvoc.core.units-module.html#u_SG_WINTER_NORTH"><a title="simvoc.core.units.u_SG_WINTER_NORTH" class="py-name" href="#" onclick="return doclink('link-33', 'u_SG_WINTER_NORTH', 'link-33');">u_SG_WINTER_NORTH</a></tt> <tt class="py-op">=</tt> <tt class="py-number">0</tt> </tt>
<a name="L93"></a><tt class="py-lineno"> 93</tt>  <tt class="py-line"><tt id="link-34" class="py-name" targets="Variable simvoc.core.units.u_SG_SPRING_NORTH=simvoc.core.units-module.html#u_SG_SPRING_NORTH"><a title="simvoc.core.units.u_SG_SPRING_NORTH" class="py-name" href="#" onclick="return doclink('link-34', 'u_SG_SPRING_NORTH', 'link-34');">u_SG_SPRING_NORTH</a></tt> <tt class="py-op">=</tt> <tt id="link-35" class="py-name"><a title="simvoc.core.units.u_SG_QUARTER" class="py-name" href="#" onclick="return doclink('link-35', 'u_SG_QUARTER', 'link-23');">u_SG_QUARTER</a></tt> </tt>
<a name="L94"></a><tt class="py-lineno"> 94</tt>  <tt class="py-line"><tt id="link-36" class="py-name" targets="Variable simvoc.core.units.u_SG_SUMMER_NORTH=simvoc.core.units-module.html#u_SG_SUMMER_NORTH"><a title="simvoc.core.units.u_SG_SUMMER_NORTH" class="py-name" href="#" onclick="return doclink('link-36', 'u_SG_SUMMER_NORTH', 'link-36');">u_SG_SUMMER_NORTH</a></tt> <tt class="py-op">=</tt> <tt class="py-number">2</tt> <tt class="py-op">*</tt> <tt id="link-37" class="py-name"><a title="simvoc.core.units.u_SG_QUARTER" class="py-name" href="#" onclick="return doclink('link-37', 'u_SG_QUARTER', 'link-23');">u_SG_QUARTER</a></tt> </tt>
<a name="L95"></a><tt class="py-lineno"> 95</tt>  <tt class="py-line"><tt id="link-38" class="py-name" targets="Variable simvoc.core.units.u_SG_AUTUMN_NORTH=simvoc.core.units-module.html#u_SG_AUTUMN_NORTH"><a title="simvoc.core.units.u_SG_AUTUMN_NORTH" class="py-name" href="#" onclick="return doclink('link-38', 'u_SG_AUTUMN_NORTH', 'link-38');">u_SG_AUTUMN_NORTH</a></tt> <tt class="py-op">=</tt> <tt class="py-number">3</tt> <tt class="py-op">*</tt> <tt id="link-39" class="py-name"><a title="simvoc.core.units.u_SG_QUARTER" class="py-name" href="#" onclick="return doclink('link-39', 'u_SG_QUARTER', 'link-23');">u_SG_QUARTER</a></tt> </tt>
<a name="L96"></a><tt class="py-lineno"> 96</tt>  <tt class="py-line"> </tt>
<a name="L97"></a><tt class="py-lineno"> 97</tt>  <tt class="py-line"><tt id="link-40" class="py-name" targets="Variable simvoc.core.units.u_MG_WINTER_NORTH=simvoc.core.units-module.html#u_MG_WINTER_NORTH"><a title="simvoc.core.units.u_MG_WINTER_NORTH" class="py-name" href="#" onclick="return doclink('link-40', 'u_MG_WINTER_NORTH', 'link-40');">u_MG_WINTER_NORTH</a></tt> <tt class="py-op">=</tt> <tt class="py-number">0</tt> </tt>
<a name="L98"></a><tt class="py-lineno"> 98</tt>  <tt class="py-line"><tt id="link-41" class="py-name" targets="Variable simvoc.core.units.u_MG_SPRING_NORTH=simvoc.core.units-module.html#u_MG_SPRING_NORTH"><a title="simvoc.core.units.u_MG_SPRING_NORTH" class="py-name" href="#" onclick="return doclink('link-41', 'u_MG_SPRING_NORTH', 'link-41');">u_MG_SPRING_NORTH</a></tt> <tt class="py-op">=</tt> <tt id="link-42" class="py-name"><a title="simvoc.core.units.u_MG_QUARTER" class="py-name" href="#" onclick="return doclink('link-42', 'u_MG_QUARTER', 'link-31');">u_MG_QUARTER</a></tt> </tt>
<a name="L99"></a><tt class="py-lineno"> 99</tt>  <tt class="py-line"><tt id="link-43" class="py-name" targets="Variable simvoc.core.units.u_MG_SUMMER_NORTH=simvoc.core.units-module.html#u_MG_SUMMER_NORTH"><a title="simvoc.core.units.u_MG_SUMMER_NORTH" class="py-name" href="#" onclick="return doclink('link-43', 'u_MG_SUMMER_NORTH', 'link-43');">u_MG_SUMMER_NORTH</a></tt> <tt class="py-op">=</tt> <tt class="py-number">2</tt> <tt class="py-op">*</tt> <tt id="link-44" class="py-name"><a title="simvoc.core.units.u_MG_QUARTER" class="py-name" href="#" onclick="return doclink('link-44', 'u_MG_QUARTER', 'link-31');">u_MG_QUARTER</a></tt> </tt>
<a name="L100"></a><tt class="py-lineno">100</tt>  <tt class="py-line"><tt id="link-45" class="py-name" targets="Variable simvoc.core.units.u_MG_AUTUMN_NORTH=simvoc.core.units-module.html#u_MG_AUTUMN_NORTH"><a title="simvoc.core.units.u_MG_AUTUMN_NORTH" class="py-name" href="#" onclick="return doclink('link-45', 'u_MG_AUTUMN_NORTH', 'link-45');">u_MG_AUTUMN_NORTH</a></tt> <tt class="py-op">=</tt> <tt class="py-number">3</tt> <tt class="py-op">*</tt> <tt id="link-46" class="py-name"><a title="simvoc.core.units.u_MG_QUARTER" class="py-name" href="#" onclick="return doclink('link-46', 'u_MG_QUARTER', 'link-31');">u_MG_QUARTER</a></tt> </tt>
<a name="L101"></a><tt class="py-lineno">101</tt>  <tt class="py-line"> </tt>
<a name="L102"></a><tt class="py-lineno">102</tt>  <tt class="py-line"><tt class="py-comment"># Southern hemisphere</tt> </tt>
<a name="L103"></a><tt class="py-lineno">103</tt>  <tt class="py-line"><tt id="link-47" class="py-name" targets="Variable simvoc.core.units.u_SG_WINTER_SOUTH=simvoc.core.units-module.html#u_SG_WINTER_SOUTH"><a title="simvoc.core.units.u_SG_WINTER_SOUTH" class="py-name" href="#" onclick="return doclink('link-47', 'u_SG_WINTER_SOUTH', 'link-47');">u_SG_WINTER_SOUTH</a></tt> <tt class="py-op">=</tt> <tt id="link-48" class="py-name"><a title="simvoc.core.units.u_SG_SUMMER_NORTH" class="py-name" href="#" onclick="return doclink('link-48', 'u_SG_SUMMER_NORTH', 'link-36');">u_SG_SUMMER_NORTH</a></tt> </tt>
<a name="L104"></a><tt class="py-lineno">104</tt>  <tt class="py-line"><tt id="link-49" class="py-name" targets="Variable simvoc.core.units.u_SG_SPRING_SOUTH=simvoc.core.units-module.html#u_SG_SPRING_SOUTH"><a title="simvoc.core.units.u_SG_SPRING_SOUTH" class="py-name" href="#" onclick="return doclink('link-49', 'u_SG_SPRING_SOUTH', 'link-49');">u_SG_SPRING_SOUTH</a></tt> <tt class="py-op">=</tt> <tt id="link-50" class="py-name"><a title="simvoc.core.units.u_SG_AUTUMN_NORTH" class="py-name" href="#" onclick="return doclink('link-50', 'u_SG_AUTUMN_NORTH', 'link-38');">u_SG_AUTUMN_NORTH</a></tt> </tt>
<a name="L105"></a><tt class="py-lineno">105</tt>  <tt class="py-line"><tt id="link-51" class="py-name" targets="Variable simvoc.core.units.u_SG_SUMMER_SOUTH=simvoc.core.units-module.html#u_SG_SUMMER_SOUTH"><a title="simvoc.core.units.u_SG_SUMMER_SOUTH" class="py-name" href="#" onclick="return doclink('link-51', 'u_SG_SUMMER_SOUTH', 'link-51');">u_SG_SUMMER_SOUTH</a></tt> <tt class="py-op">=</tt> <tt id="link-52" class="py-name"><a title="simvoc.core.units.u_SG_WINTER_NORTH" class="py-name" href="#" onclick="return doclink('link-52', 'u_SG_WINTER_NORTH', 'link-33');">u_SG_WINTER_NORTH</a></tt> </tt>
<a name="L106"></a><tt class="py-lineno">106</tt>  <tt class="py-line"><tt id="link-53" class="py-name" targets="Variable simvoc.core.units.u_SG_AUTUMN_SOUTH=simvoc.core.units-module.html#u_SG_AUTUMN_SOUTH"><a title="simvoc.core.units.u_SG_AUTUMN_SOUTH" class="py-name" href="#" onclick="return doclink('link-53', 'u_SG_AUTUMN_SOUTH', 'link-53');">u_SG_AUTUMN_SOUTH</a></tt> <tt class="py-op">=</tt> <tt id="link-54" class="py-name"><a title="simvoc.core.units.u_SG_SPRING_NORTH" class="py-name" href="#" onclick="return doclink('link-54', 'u_SG_SPRING_NORTH', 'link-34');">u_SG_SPRING_NORTH</a></tt> </tt>
<a name="L107"></a><tt class="py-lineno">107</tt>  <tt class="py-line"> </tt>
<a name="L108"></a><tt class="py-lineno">108</tt>  <tt class="py-line"><tt id="link-55" class="py-name" targets="Variable simvoc.core.units.u_MG_WINTER_SOUTH=simvoc.core.units-module.html#u_MG_WINTER_SOUTH"><a title="simvoc.core.units.u_MG_WINTER_SOUTH" class="py-name" href="#" onclick="return doclink('link-55', 'u_MG_WINTER_SOUTH', 'link-55');">u_MG_WINTER_SOUTH</a></tt> <tt class="py-op">=</tt> <tt id="link-56" class="py-name"><a title="simvoc.core.units.u_MG_SUMMER_NORTH" class="py-name" href="#" onclick="return doclink('link-56', 'u_MG_SUMMER_NORTH', 'link-43');">u_MG_SUMMER_NORTH</a></tt> </tt>
<a name="L109"></a><tt class="py-lineno">109</tt>  <tt class="py-line"><tt id="link-57" class="py-name" targets="Variable simvoc.core.units.u_MG_SPRING_SOUTH=simvoc.core.units-module.html#u_MG_SPRING_SOUTH"><a title="simvoc.core.units.u_MG_SPRING_SOUTH" class="py-name" href="#" onclick="return doclink('link-57', 'u_MG_SPRING_SOUTH', 'link-57');">u_MG_SPRING_SOUTH</a></tt> <tt class="py-op">=</tt> <tt id="link-58" class="py-name"><a title="simvoc.core.units.u_MG_AUTUMN_NORTH" class="py-name" href="#" onclick="return doclink('link-58', 'u_MG_AUTUMN_NORTH', 'link-45');">u_MG_AUTUMN_NORTH</a></tt> </tt>
<a name="L110"></a><tt class="py-lineno">110</tt>  <tt class="py-line"><tt id="link-59" class="py-name" targets="Variable simvoc.core.units.u_MG_SUMMER_SOUTH=simvoc.core.units-module.html#u_MG_SUMMER_SOUTH"><a title="simvoc.core.units.u_MG_SUMMER_SOUTH" class="py-name" href="#" onclick="return doclink('link-59', 'u_MG_SUMMER_SOUTH', 'link-59');">u_MG_SUMMER_SOUTH</a></tt> <tt class="py-op">=</tt> <tt id="link-60" class="py-name"><a title="simvoc.core.units.u_MG_WINTER_NORTH" class="py-name" href="#" onclick="return doclink('link-60', 'u_MG_WINTER_NORTH', 'link-40');">u_MG_WINTER_NORTH</a></tt> </tt>
<a name="L111"></a><tt class="py-lineno">111</tt>  <tt class="py-line"><tt id="link-61" class="py-name" targets="Variable simvoc.core.units.u_MG_AUTUMN_SOUTH=simvoc.core.units-module.html#u_MG_AUTUMN_SOUTH"><a title="simvoc.core.units.u_MG_AUTUMN_SOUTH" class="py-name" href="#" onclick="return doclink('link-61', 'u_MG_AUTUMN_SOUTH', 'link-61');">u_MG_AUTUMN_SOUTH</a></tt> <tt class="py-op">=</tt> <tt id="link-62" class="py-name"><a title="simvoc.core.units.u_MG_SPRING_NORTH" class="py-name" href="#" onclick="return doclink('link-62', 'u_MG_SPRING_NORTH', 'link-41');">u_MG_SPRING_NORTH</a></tt> </tt>
<a name="L112"></a><tt class="py-lineno">112</tt>  <tt class="py-line"> </tt>
<a name="L113"></a><tt class="py-lineno">113</tt>  <tt class="py-line"> </tt>
<a name="L114"></a><tt class="py-lineno">114</tt>  <tt class="py-line"><tt class="py-comment">############################## Formatting Functions ##########################</tt> </tt>
<a name="L115"></a><tt class="py-lineno">115</tt>  <tt class="py-line"> </tt>
<a name="L116"></a><tt class="py-lineno">116</tt>  <tt class="py-line"><tt class="py-comment"># size in BYTES</tt> </tt>
<a name="fmt_size"></a><div id="fmt_size-def"><a name="L117"></a><tt class="py-lineno">117</tt> <a class="py-toggle" href="#" id="fmt_size-toggle" onclick="return toggle('fmt_size');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="simvoc.core.units-module.html#fmt_size">fmt_size</a><tt class="py-op">(</tt><tt class="py-param">size</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="fmt_size-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="fmt_size-expanded"><a name="L118"></a><tt class="py-lineno">118</tt>  <tt class="py-line">   <tt class="py-docstring">'''</tt> </tt>
<a name="L119"></a><tt class="py-lineno">119</tt>  <tt class="py-line"><tt class="py-docstring">   Produces a human-readable representation of a size in bytes. This readable</tt> </tt>
<a name="L120"></a><tt class="py-lineno">120</tt>  <tt class="py-line"><tt class="py-docstring">   representation will use a binary magnitude unit (B, KiB, MiB, GiB, TiB,</tt> </tt>
<a name="L121"></a><tt class="py-lineno">121</tt>  <tt class="py-line"><tt class="py-docstring">   or PiB). Values over 1024 pebibytes will be reported in pebibytes.</tt> </tt>
<a name="L122"></a><tt class="py-lineno">122</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
<a name="L123"></a><tt class="py-lineno">123</tt>  <tt class="py-line"><tt class="py-docstring">   @param size: Size to convert, in bytes</tt> </tt>
<a name="L124"></a><tt class="py-lineno">124</tt>  <tt class="py-line"><tt class="py-docstring">   @type size: int</tt> </tt>
<a name="L125"></a><tt class="py-lineno">125</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
<a name="L126"></a><tt class="py-lineno">126</tt>  <tt class="py-line"><tt class="py-docstring">   @rtype: str</tt> </tt>
<a name="L127"></a><tt class="py-lineno">127</tt>  <tt class="py-line"><tt class="py-docstring">   @return: a string containing the formatted quantity with a unit name</tt> </tt>
<a name="L128"></a><tt class="py-lineno">128</tt>  <tt class="py-line"><tt class="py-docstring">   '''</tt> </tt>
<a name="L129"></a><tt class="py-lineno">129</tt>  <tt class="py-line">   <tt class="py-name">names</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt> <tt class="py-op">(</tt><tt class="py-string">'B'</tt><tt class="py-op">,</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-string">'KiB'</tt><tt class="py-op">,</tt> <tt id="link-63" class="py-name"><a title="simvoc.core.units.u_KiB" class="py-name" href="#" onclick="return doclink('link-63', 'u_KiB', 'link-1');">u_KiB</a></tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-string">'MiB'</tt><tt class="py-op">,</tt> <tt id="link-64" class="py-name"><a title="simvoc.core.units.u_MiB" class="py-name" href="#" onclick="return doclink('link-64', 'u_MiB', 'link-3');">u_MiB</a></tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-string">'GiB'</tt><tt class="py-op">,</tt> <tt id="link-65" class="py-name"><a title="simvoc.core.units.u_GiB" class="py-name" href="#" onclick="return doclink('link-65', 'u_GiB', 'link-5');">u_GiB</a></tt><tt class="py-op">)</tt><tt class="py-op">,</tt> \ </tt>
<a name="L130"></a><tt class="py-lineno">130</tt>  <tt class="py-line">             <tt class="py-op">(</tt><tt class="py-string">'TiB'</tt><tt class="py-op">,</tt> <tt id="link-66" class="py-name"><a title="simvoc.core.units.u_TiB" class="py-name" href="#" onclick="return doclink('link-66', 'u_TiB', 'link-7');">u_TiB</a></tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-string">'PiB'</tt><tt class="py-op">,</tt> <tt id="link-67" class="py-name"><a title="simvoc.core.units.u_PiB" class="py-name" href="#" onclick="return doclink('link-67', 'u_PiB', 'link-9');">u_PiB</a></tt><tt class="py-op">)</tt> <tt class="py-op">]</tt> </tt>
<a name="L131"></a><tt class="py-lineno">131</tt>  <tt class="py-line">   <tt class="py-name">szf</tt> <tt class="py-op">=</tt> <tt class="py-name">float</tt><tt class="py-op">(</tt><tt class="py-name">size</tt><tt class="py-op">)</tt> </tt>
<a name="L132"></a><tt class="py-lineno">132</tt>  <tt class="py-line">   <tt class="py-name">value</tt> <tt class="py-op">=</tt> <tt class="py-number">0</tt> </tt>
<a name="L133"></a><tt class="py-lineno">133</tt>  <tt class="py-line">   <tt class="py-name">chosen</tt> <tt class="py-op">=</tt> <tt class="py-string">'B'</tt> </tt>
<a name="L134"></a><tt class="py-lineno">134</tt>  <tt class="py-line">   <tt class="py-keyword">for</tt> <tt class="py-name">name</tt><tt class="py-op">,</tt> <tt class="py-name">fact</tt> <tt class="py-keyword">in</tt> <tt class="py-name">names</tt><tt class="py-op">:</tt> </tt>
<a name="L135"></a><tt class="py-lineno">135</tt>  <tt class="py-line">      <tt class="py-name">x</tt> <tt class="py-op">=</tt> <tt class="py-name">szf</tt> <tt class="py-op">/</tt> <tt class="py-name">float</tt><tt class="py-op">(</tt><tt class="py-name">fact</tt><tt class="py-op">)</tt> </tt>
<a name="L136"></a><tt class="py-lineno">136</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">x</tt> <tt class="py-op">&lt;</tt> <tt class="py-number">1</tt><tt class="py-op">:</tt> </tt>
<a name="L137"></a><tt class="py-lineno">137</tt>  <tt class="py-line">         <tt class="py-keyword">break</tt> </tt>
<a name="L138"></a><tt class="py-lineno">138</tt>  <tt class="py-line">      <tt class="py-name">chosen</tt> <tt class="py-op">=</tt> <tt class="py-name">name</tt> </tt>
<a name="L139"></a><tt class="py-lineno">139</tt>  <tt class="py-line">      <tt class="py-name">value</tt> <tt class="py-op">=</tt> <tt class="py-name">x</tt> </tt>
<a name="L140"></a><tt class="py-lineno">140</tt>  <tt class="py-line">   <tt class="py-keyword">return</tt> <tt class="py-string">'%0.2f %s'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">,</tt> <tt class="py-name">chosen</tt><tt class="py-op">)</tt> </tt>
</div><a name="L141"></a><tt class="py-lineno">141</tt>  <tt class="py-line"><tt class="py-comment">#</tt> </tt>
<a name="L142"></a><tt class="py-lineno">142</tt>  <tt class="py-line"> </tt>
<a name="L143"></a><tt class="py-lineno">143</tt>  <tt class="py-line"><tt class="py-comment"># speed in BYTES per second</tt> </tt>
<a name="fmt_speed"></a><div id="fmt_speed-def"><a name="L144"></a><tt class="py-lineno">144</tt> <a class="py-toggle" href="#" id="fmt_speed-toggle" onclick="return toggle('fmt_speed');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="simvoc.core.units-module.html#fmt_speed">fmt_speed</a><tt class="py-op">(</tt><tt class="py-param">speed</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
</div><div id="fmt_speed-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="fmt_speed-expanded"><a name="L145"></a><tt class="py-lineno">145</tt>  <tt class="py-line">   <tt class="py-docstring">'''</tt> </tt>
<a name="L146"></a><tt class="py-lineno">146</tt>  <tt class="py-line"><tt class="py-docstring">   Produces a human-readable speed indication in *bits* per second, with</tt> </tt>
<a name="L147"></a><tt class="py-lineno">147</tt>  <tt class="py-line"><tt class="py-docstring">   decimal magnitude units (bps, Kbps, Mbps, or Gbps), from a speed input in</tt> </tt>
<a name="L148"></a><tt class="py-lineno">148</tt>  <tt class="py-line"><tt class="py-docstring">   *BYTES* per second. Values over 1000 Gbps will be reported in Gbps.</tt> </tt>
<a name="L149"></a><tt class="py-lineno">149</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
<a name="L150"></a><tt class="py-lineno">150</tt>  <tt class="py-line"><tt class="py-docstring">   @param speed: Speed in BYTES per second</tt> </tt>
<a name="L151"></a><tt class="py-lineno">151</tt>  <tt class="py-line"><tt class="py-docstring"></tt> </tt>
<a name="L152"></a><tt class="py-lineno">152</tt>  <tt class="py-line"><tt class="py-docstring">   @rtype: str</tt> </tt>
<a name="L153"></a><tt class="py-lineno">153</tt>  <tt class="py-line"><tt class="py-docstring">   @return: a string containing the formatted quantity with a unit name</tt> </tt>
<a name="L154"></a><tt class="py-lineno">154</tt>  <tt class="py-line"><tt class="py-docstring">   '''</tt> </tt>
<a name="L155"></a><tt class="py-lineno">155</tt>  <tt class="py-line">   <tt class="py-name">names</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">(</tt><tt class="py-string">'bps'</tt><tt class="py-op">,</tt> <tt class="py-number">0.125</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-string">'Kbps'</tt><tt class="py-op">,</tt> <tt id="link-68" class="py-name"><a title="simvoc.core.units.u_Kbps" class="py-name" href="#" onclick="return doclink('link-68', 'u_Kbps', 'link-10');">u_Kbps</a></tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-string">'Mbps'</tt><tt class="py-op">,</tt> <tt id="link-69" class="py-name"><a title="simvoc.core.units.u_Mbps" class="py-name" href="#" onclick="return doclink('link-69', 'u_Mbps', 'link-12');">u_Mbps</a></tt><tt class="py-op">)</tt><tt class="py-op">,</tt> \ </tt>
<a name="L156"></a><tt class="py-lineno">156</tt>  <tt class="py-line">            <tt class="py-op">(</tt><tt class="py-string">'Gbps'</tt><tt class="py-op">,</tt> <tt id="link-70" class="py-name"><a title="simvoc.core.units.u_Gbps" class="py-name" href="#" onclick="return doclink('link-70', 'u_Gbps', 'link-14');">u_Gbps</a></tt><tt class="py-op">)</tt><tt class="py-op">]</tt> </tt>
<a name="L157"></a><tt class="py-lineno">157</tt>  <tt class="py-line">   <tt class="py-name">spf</tt> <tt class="py-op">=</tt> <tt class="py-name">float</tt><tt class="py-op">(</tt><tt class="py-name">speed</tt><tt class="py-op">)</tt> </tt>
<a name="L158"></a><tt class="py-lineno">158</tt>  <tt class="py-line">   <tt class="py-name">value</tt> <tt class="py-op">=</tt> <tt class="py-number">0</tt> </tt>
<a name="L159"></a><tt class="py-lineno">159</tt>  <tt class="py-line">   <tt class="py-name">chosen</tt> <tt class="py-op">=</tt> <tt class="py-string">'less than 1 bps'</tt> </tt>
<a name="L160"></a><tt class="py-lineno">160</tt>  <tt class="py-line">   <tt class="py-keyword">if</tt> <tt class="py-name">speed</tt> <tt class="py-op">==</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt>
<a name="L161"></a><tt class="py-lineno">161</tt>  <tt class="py-line">      <tt class="py-keyword">return</tt> <tt class="py-string">'&lt;speed unused&gt;'</tt> </tt>
<a name="L162"></a><tt class="py-lineno">162</tt>  <tt class="py-line">   <tt class="py-keyword">for</tt> <tt class="py-name">name</tt><tt class="py-op">,</tt> <tt class="py-name">fact</tt> <tt class="py-keyword">in</tt> <tt class="py-name">names</tt><tt class="py-op">:</tt> </tt>
<a name="L163"></a><tt class="py-lineno">163</tt>  <tt class="py-line">      <tt class="py-name">x</tt> <tt class="py-op">=</tt> <tt class="py-name">spf</tt> <tt class="py-op">/</tt> <tt class="py-name">float</tt><tt class="py-op">(</tt><tt class="py-name">fact</tt><tt class="py-op">)</tt> </tt>
<a name="L164"></a><tt class="py-lineno">164</tt>  <tt class="py-line">      <tt class="py-keyword">if</tt> <tt class="py-name">x</tt> <tt class="py-op">&lt;</tt> <tt class="py-number">1</tt><tt class="py-op">:</tt> </tt>
<a name="L165"></a><tt class="py-lineno">165</tt>  <tt class="py-line">         <tt class="py-keyword">break</tt> </tt>
<a name="L166"></a><tt class="py-lineno">166</tt>  <tt class="py-line">      <tt class="py-name">chosen</tt> <tt class="py-op">=</tt> <tt class="py-name">name</tt> </tt>
<a name="L167"></a><tt class="py-lineno">167</tt>  <tt class="py-line">      <tt class="py-name">value</tt> <tt class="py-op">=</tt> <tt class="py-name">x</tt> </tt>
<a name="L168"></a><tt class="py-lineno">168</tt>  <tt class="py-line">   <tt class="py-keyword">return</tt> <tt class="py-string">'%0.2f %s'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">value</tt><tt class="py-op">,</tt> <tt class="py-name">chosen</tt><tt class="py-op">)</tt> </tt>
</div><a name="L169"></a><tt class="py-lineno">169</tt>  <tt class="py-line"><tt class="py-comment">#</tt> </tt>
<a name="L170"></a><tt class="py-lineno">170</tt>  <tt class="py-line"> </tt><script type="text/javascript">
<!--
expandto(location.href);
// -->
</script>
</pre>
<br />
<!-- ==================== NAVIGATION BAR ==================== -->
<table class="navbar" border="0" width="100%" cellpadding="0"
       bgcolor="#a0c0ff" cellspacing="0">
  <tr valign="middle">
  <!-- Home link -->
      <th>&nbsp;&nbsp;&nbsp;<a
        href="simvoc-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>

  <!-- Tree link -->
      <th>&nbsp;&nbsp;&nbsp;<a
        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>

  <!-- Index link -->
      <th>&nbsp;&nbsp;&nbsp;<a
        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>

  <!-- Help link -->
      <th>&nbsp;&nbsp;&nbsp;<a
        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>

  <!-- Project homepage -->
      <th class="navbar" align="right" width="100%">
        <table border="0" cellpadding="0" cellspacing="0">
          <tr><th class="navbar" align="center"
            >SimVOC</th>
          </tr></table></th>
  </tr>
</table>
<table border="0" cellpadding="0" cellspacing="0" width="100%%">
  <tr>
    <td align="left" class="footer">
    Generated by Epydoc 3.0 on Fri Oct 23 11:04:35 2009
    </td>
    <td align="right" class="footer">
      <a target="mainFrame" href="http://epydoc.sourceforge.net"
        >http://epydoc.sourceforge.net</a>
    </td>
  </tr>
</table>

<script type="text/javascript">
  <!--
  // Private objects are initially displayed (because if
  // javascript is turned off then we want them to be
  // visible); but by default, we want to hide them.  So hide
  // them unless we have a cookie that says to show them.
  checkCookie();
  // -->
</script>
</body>
</html>
